From 2e1114c9fab26d7a0174ec9fc89755814996d13e Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sun, 28 Feb 2021 13:00:55 -0500
Subject: [PATCH] customfilter: Convert docs

---
 gtk/gtkcustomfilter.c | 15 ++++++---------
 gtk/gtkcustomfilter.h |  1 +
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/gtk/gtkcustomfilter.c b/gtk/gtkcustomfilter.c
index 34f7dfb1cd..97c86e2470 100644
--- a/gtk/gtkcustomfilter.c
+++ b/gtk/gtkcustomfilter.c
@@ -25,12 +25,9 @@
 #include "gtktypebuiltins.h"
 
 /**
- * SECTION:gtkcustomfilter
- * @Title: GtkCustomFilter
- * @Short_description: Filtering with callbacks
+ * GtkCustomFilter:
  *
- * #GtkCustomFilter is a #GtkFilter that uses a callback to determine
- * whether to include an item or not.
+ * `GtkCustomFilter` determines whether to include items with a callback.
  */
 struct _GtkCustomFilter
 {
@@ -108,7 +105,7 @@ gtk_custom_filter_init (GtkCustomFilter *self)
  * If the filter func changes its filtering behavior,
  * gtk_filter_changed() needs to be called.
  *
- * Returns: a new #GtkCustomFilter
+ * Returns: a new `GtkCustomFilter`
  **/
 GtkCustomFilter *
 gtk_custom_filter_new (GtkCustomFilterFunc match_func,
@@ -126,12 +123,12 @@ gtk_custom_filter_new (GtkCustomFilterFunc match_func,
 
 /**
  * gtk_custom_filter_set_filter_func:
- * @self: a #GtkCustomFilter
+ * @self: a `GtkCustomFilter`
  * @match_func: (nullable): function to filter items
  * @user_data: (nullable): user data to pass to @match_func
  * @user_destroy: destroy notify for @user_data
  *
- * Sets (or unsets) the function used for filtering items.
+ * Sets the function used for filtering items.
  *
  * If @match_func is %NULL, the filter matches all items.
  *
@@ -140,7 +137,7 @@ gtk_custom_filter_new (GtkCustomFilterFunc match_func,
  *
  * If a previous function was set, its @user_destroy will be
  * called now.
- **/
+ */
 void
 gtk_custom_filter_set_filter_func (GtkCustomFilter     *self,
                                    GtkCustomFilterFunc  match_func,
diff --git a/gtk/gtkcustomfilter.h b/gtk/gtkcustomfilter.h
index 784e4fdca9..ba2fae055e 100644
--- a/gtk/gtkcustomfilter.h
+++ b/gtk/gtkcustomfilter.h
@@ -34,6 +34,7 @@ G_BEGIN_DECLS
  * @user_data: user data
  *
  * User function that is called to determine if the @item should be matched.
+ *
  * If the filter matches the item, this function must return %TRUE. If the
  * item should be filtered out, %FALSE must be returned.
  *
-- 
2.30.2